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jill Introduction 


Chapter | The Data Access Macro opens up the world of external databases so that you 
. can access them with Microsoft» Excel. Many companies keep databases of 

' customers, orders, financial information, and so on. The Data Access Macro 
me gives you access to this data so that you can analyze it in Microsoft Excel. — 


Microsoft Excel for the Apple Macintosh uses the Data Access Language 
(DAL) from Apple Computer, Inc. to access data on external databases and 
dats “ transfer query results to Microsoft Excel worksheets. Microsoft Excel offers 
ee ha you the ability to use familiar database commands to query external data. For 
POV prelate Him a review of Microsoft Excel database concepts, see Chapter 9, “Creating and 

Using a Database on a Worksheet,” and Chapter 10, “Analyzing and Report- 
ing Database Information,” in the Microsoft Excel User's Guide. For more 
information about Apple's Data Access Language, advanced users can 
contact Apple Programmers and Developers Association (APDA), c/o Apple 
Computer, 20525 Mariana, Cupertino, CA 95014. 


To use DAL to access data from a host: 
= DAL must be installed on your Macintosh. 
# Your Macintosh must be connected to a network. 


= The DAL server program must be installed on the host system you want 
to access. 


= Authorization, in the form of an account and password, to sign on to your 
host and database. 


You may need setup assistance from a system administrator or MIS support 
personnel to set up and use DAL. 


About the Data Access Macro 


When the Data Access Macro is open, four new commands—Paste 
Fieldnames, SQL Query, Query Assistant, and Close Connection—appear on 


the Data menu, and one new command—Query Destination—appears on the 
, Options menu. 


With these commands and Microsoft Excel's built-in Data commands, you 
can easily recall predefined queries or create new queries, and then submit 
them to remote databases for processing without having to leam SQL 
(Structured Query Language). 
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To access a remote database once you are running Microsoft Excel: 
e Open the Data Access Macro. 
= Specify the external database to which you want to connect. 


# Select the field names and enter the criteria that tell Microsoft Excel 
which records you want to extract. Microsoft Excel displays a list of field 
names from which you can choose. 


« Select the field names you want to extract and tell Microsoft Excel to 
extract the data from the database. 


You perform these steps using the commands on the Data menu. The dialog 
boxes for these commands allow you to connect to the database, select field 
names, and extract data. Microsoft Excel generates the appropriate DAL 
instructions and sends them to your host database. 


To complete the last two steps, you can use either the Data Paste Fieldnames 
command and the Data Extract command, or you can use the Query Assis- 
tant. When you choose the Data Query Assistant command, dialog boxes 
lead you through the process of building your queries. 


The Data SQL Query command allows more experienced database and SQL 
users to edit predefined queries or bypass the preceding four basic steps. 
Advanced users can directly enter SQL instructions and submit them for 
processing without having to leave Microsoft Excel. 


Microsoft Excel also provides you with a number of choices if you want to 
use a separate query tool, such as ClearAccess or GQL. You can create and 
run a query using one of these products, and then copy and paste your data 
into Microsoft Excel. You can also use one of these products to create a 
number of standard queries and save them. Using the Data SQL Query 
command, you can then open any one of these queries and edit and run it. 
The data you query will be returned directly to Microsoft Excel. 


If you are using system software version 7.0, Microsoft Excel gives you the 
capability to execute a version 7.0 query document and download the result 
directly to your worksheet or to a text file. 


Since you can open any text file in the Data SQL Query dialog box, you can 
also write a query in any text editor, such as Microsoft® Word. 
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How to Use This Book 


Chapter 2, “Using the Data Access Macro,” explains how to log on to an 
external database and then create and run a query of external data using the 
commands on the Data menu. 


Chapter 3, “Using the Query Assistant,” shows you how to use the Query 
Assistant to create and run a query. 


Chapter 4, “Using Functions with DAL,” lists the worksheet and command 
equivalent functions included in the Data Access Macro. By using these 
functions in your macros, you can create queries that can be run from a 
custom menu. You can share these macros with others to simplify their 
access to external databases. 


Installing and Opening the Data Access Macro 


NOTE 


If you chose not to install the Microsoft Excel Data Access Macro when you 
set up Microsoft Excel, you need to install it now. 


It is important that you install the Data Access Macro by using the installation 
procedure designed for your computer's operating system. For specific 
instructions, see “Installing Microsoft Excel” in Microsoft Excel Getting 
Started. 


Once the Data Access Macro is installed, you open it just as you open any 
Microsoft Excel worksheet. You can open it with Microsoft Excel already 
running or open it as you start Microsoft Excel. 


sun Opening the Data Access Macro from Microsoft Excel 

1 Choose File Open. 

2 Change to the Data Access Files folder. 

3 Double-click Data Access Macro in the list box. 

sus Starting Microsoft Excel and opening the Data Access 
Macro 


> Double-click the Data Access Macro icon to start Microsoft Excel and 
open the macro sheet. 


You can also include the Data Access Macro in the Excel Startup Folder in 
your System folder to automatically open it every time you start Microsoft 

Excel. For more information, see Chapter 16, “Customizing the Workspace 
and Protecting Data” in the Microsoft Excel User's Guide. 
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Using the Data Access Macro 


To access a remote database once you are running Microsoft Excel and have 
opened the Data Access Macro: 


a Spectly the external database to which you want to connect 


= Select the field names and enter the criteria that tell Microsoft Excel 
which records you want to extract. Microsoft Excel displays a list of field 
names from which you can choose. 


e Select the field names you want to extract and tell Microsoft Excel to 
extract the data from the database. 


You perform these steps using the commands on the Data menu. The dialog 
boxes for these commands allow you to connect to the database, select field 
names, and extract data. Microsoft Excel generates the appropriate DAL 
instructions and sends them to your host database. 


Once you are connected to a database, you can also select field names, 
specify criteria, and run a query using the Data Query Assistant dialog box. 
This method is described in Chapter 3, “Using the Query Assistant.” You 
may find this method easier when you are first learning how to generate 
queries. 


Connecting to an External Database 


Use the Data Set Database command to either set a database in Microsoft 
Excel or to specify the external system and database to which you want to 
connect. When you specify an external database, you can either select from a 
list of choices that you or your system administrator have already defined, or 
you can define, name, and save a new login script. 


Set External Detebese 


& Continuous Connection 
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A login script contains information about your host computer, and about the 
database management system (DBMS) and the database you want to query. It 
also can contain the user names and passwords for the host, DBMS, and 
database, if they are required. You must choose the Data Set Database com- 
mand to create a login script or select an existing login script before you can 
query the database. 


You can share login scripts with other users, just like any file. Be careful 
about sharing login scripts that contain user names and passwords that are 
confidential. If you don't want others to have access to those databases, don’t 
share those login scripts. You can create login scripts without the passwords 
by leaving the Prompt Each Login check box turned on in the dialog boxes 
you see when you create the script. When you log in, you will be prompted 
for each password. Users who don’t know the passwords won't be able to 
access the remote databases. If a password is not required, select the No 
Password Required option so you won't be prompted for a password the next 
time this login script is selected. 


To create a new login script, you need to know the names of your host 
system, DBMS, and database, plus the user names and passwords to access 
each. 


a aa to an external database using an existing login 
script 

Choose Data Set Database. 

Select the External Database option. 

Choose OK. 


Select the name of the external database login script you want to use. 


aa@qgny» = 


If you do not want a continuous connection with the external database, 
turn off the Continuous Connection check box. 


6 Choose OK. 


nin Changing the connection to another external database 


When you are already connected to a database, the Host, DBMS Brand, and 
Database are listed in the Data Set Database dialog box. You can change to 
another database by choosing the Change button and selecting the database. 


1 Choose Data Set Database. 

2 Choose the Change button. 

3 Select the name of the external database login script you want to use. 
4 


If you do not want a continuous connection with the external database, 
turn off the Continuous Connection check box. 


5 Choose OK. 
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uu Creating a login script and connecting to an external 


database 
Choose Data Set Database. 
Select the External Database option and choose OK. 


If you do not want a continuous connection with the external database, 
turn off the Continuous Connection check box. 


Choose the New button. 


In the Host Name dialog box, select the name of your host system. The 
options in the Host Name box are supplied by DAL. If you don’t see 
the option you want, modify the host.cll file or contact your system 
administrator. 


O Ne Password Required 
[Prompt Eech Login 


In the Username box, type your assigned user name for the selected host 
computer. 


If you need to use a password to gain access to the host, type the pass- 
word in the Password box. 


If a password is not required, select the No Password Required option. 


If you want Microsoft Excel to enter the password for you each time you 
connect to the host computer, turn off the Prompt Each Login check box. 
If you leave the check box turned on, Microsoft Excel prompts you for 
the password. 


Choose OK. 


Microsoft Excel displays a message on the status bar saying that it is 
connecting to the host. 


In the DBMS Brand dialog box, select the database management system 
you want to use, 
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10) If the database management system requires a user name and password, 
type them in the Username and Password boxes, 


If a password is not required, select the No Password Required option, 


I you want Microsoft Excel to enter the password for you each time you 
connect tothe datebaee, tieeofl the Prompt Pah Login eleek boa Tf 
you leave the cheek box turned on, Micronolt Excel prompin you for the 
password. 


11. Choose OK. 


Microsoit Excel displays a message on the status bar saying that it is 
opening the DBMS. 


12 If the database management system supports the location function, the 
Search For Databases In dialog box is displayed. In this dialog box, type 
the pathname to the database you want to use, and then choose OK. Be 
sure to use the syntax required by the remote database. 


For example, the following illustration shows the location of a directory 
containing the databases of interest on the VMS operating system: 


Search for Databases in: 





The syntax used must match that expected by the database management 
system. Microsoft Excel will not check it for you. For more information 
about the location function, consult your Data Access Language manual. 
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13. In the <dbms> Databases dialog box, select the database you want to 


query. 


Rudit_1989 
Phonetist 
Invoice_prd 


Username: apr), 


Pel ae 
@ Inter: | | 
CO No Password Nequired 


| | Prompt fach Login 





14) THorequired by the databawe, type the allow, aver name, and password, 
You une the Atti bond fo aaniga a logieal name toa datibane, 
If a password is not required, select the No Password Required option. 


If you want Microsoft Excel to enter the password for you each time you 
connect to the database, turn off the Prompt Each Login check box. If 
you leave the check box turned on, Microsoft Excel prompts you for the 
password. 


Microsoft Excel displays a message on the status bar saying that it is 
opening the database. 


15 Toconnect to the database and save the login script, choose OK. Type a 
name for the login script in the Save dialog box. 


To connect to the database without saving the script, choose the Close 
button. 


Messages 

a Microsoft Excel tells you if it cannot connect to the external database, 
either because it cannot establish a connection, or because it does not 
have valid host information. Consult your Data Access Language system 
documentation or ask your system administrator for assistance. 
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Selecting Field Names from the External Database 


After you connect to the external database, you select the fields to use in 
your criteria range and in your extract range. For more information on 
criteria and extract ranges, see Chapter 10, “Analyzing and Reporting 
Database Information” in the Microsoft Excel User's Guide. You can select 
all the field names at one time, or you can select just the field names you 
want to use for the criteria range, and then later select the field names for the 
extract range, 


You use the Date Paste Fieldnames command to select the field names. The 
Held names are pasted into your worksheet, starting with the wetive cell and 
confining fo the right wotil all the field names are pasted, 


Tables in the database Fiaide in the selected table 


customer:addr! 
customer:eddr2 
| | customer:cont_dote 
j | customer:credit_line 
customer:cust_cit 


customer:cust_name 
orders:order_amount 
customer:recetveble 
customer:credit_tine 
orders:order_nr 





Use these buttons to add and remove 
fields from the Selected Fields box. 


The field n2™es are a combination of the table that contains the field and 
the field name, in the format fable :fieldname. For example, a field named 


“orders:cust_nr” tells you that the information you extract will come from 
the cust_nr field in the Orders table. 


The selected field names are listed in the Selected Fields box. Using the 
buttons in the dialog box, you can add all the field names, clear all the field 
names, or add or delete individual field names. 
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sunt Selecting field names from the database 


1 
2 


Choose Data Paste Fieldnames. 


In the Table box, select the table containing the information you want to 
extract. 


In the Field box, select the names of the fields you want in your 
Microsoft Excel worksheet. 


To select more than one field name, hold down siier and click the Held 
names, 


Hf you want to inacet the Feld names into those already listed in the 
Selected Viehds lint, aeleet the position where you want the new tela 
OULU By 


To add the selected Meld names, choore the Add button, 
To add all field names, choose the Add All button. 


To remove field names, select the field names you want to remove and 
choose the Remove button. 


To remove all field names, choose the Clear All button. 
When the appropriate field names are selected, choose the Paste button. 


Microsoft Excel displays a message on the status bar saying that it is 
pasting field names. 


Messages 


If you attempt to select more than 255 field names, you will see a mes- 
sage that you have selected too many field names, and the Data Paste 


Fieldnames dialog box will appear so you can remove some of the field 
names. 


If you attempt to extract and paste field names before setting the data- 
base, you will see a message that the database is not defined. Connect to 
the database you want to use and then continue. 


If there is a problem accessing the DBMS or the requested field names, 
you will see a message saying that there is a problem and the process will 
stop. Consult your Data Access Language manual or check with your 
system administrator for help with the message. 


Extracting Data from the External Database 


Helore yor can extinct dita, vor need to pives Mierowott Maced information 
vbowt what thi toeatiiet by deliniog (he criteria range and (he eatiiet range, 


To identify the criteria range: 


» Enter the criteria beneath the field names you have listed in your 
worksheet. 


s Define the criteria range by selecting the field names and the criteria 
entered below them. 


s Choose Data Set Criteria. 
To identify the extract range: 


ws Use the Data Paste Fieldnames command to place on the worksheet the 
names of the fields you want to extract. 


e Define the extract range by selecting either the field names that you want 
to extract or the field names and a range of cells. 


a Choose Data Set Extract. 
To extract the data: 
ws Choose Data Extract. 


Entering the Criteria 


When you enter criteria, you are telling Microsoft Excel which records you 
want to extract from the database. If no criteria are defined, all records are 
extracted. 


To enter criteria, you type them beneath the appropriate field name. For 
example, you could enter a criterion to extract customer records for those 
customers who owe more than $5,000. 


Table Field 
name name 








You can use the following arithmetic operators when entering criteria; 


Operation Operator 
Adtdition a7 
Subtraction - 
Multiplication 2 
Division / 
Equal = 
Not equal to <> 
Less than < 
Less than or equal to <= 
Greater than > 
Greater than or equal to a 


The way you enter criteria to query a database that resides within Microsoft 
Excel is somewhat different from the way you enter criteria to query a data- 
base external to Microsoft Excel. When you query an external database, you 
can use SQL-like commands, which are different from Microsoft Excel 
commands. 


The following sections highlight these differences. For more information 
about Microsoft Excel criteria, see Chapter 10, “Analyzing and Reporting 
Database Information,” in the Microsoft Excel User's Guide. There are 
several books available that provide comprehensive instructions on SQL. 


Simple Comparison Criteria 


The following example shows how simple comparison criteria differ in 
Microsoft Excel and in SQL. Suppose you want to find records for all 
customers in Atlanta who owe more than $10,000. 


To query a Microsoft Excel database, you enter: 
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If you wanted a listing of all customers whose receivables, together with 
their last order, exceeded their credit line, in SQL you enter: 


To query an external database using SQL, you enter: 





Field 
ee , This field name should refer to 
. the field name you are querying. 
( Nepasceviotered teesevovsdouneosoncaisces Npivteresdrerersarer sectbevdincawsssshsseiesent 
Criterion 
In a computed criterion, you Can include a formula 
Computed Criteria 


refering lo nine than one held 
The following example shows how Microsoft Excel computed criteria differ 
from SQL computed criteria. Suppose you want to generate a list of all 
customers whose receivables exceed their credit line. 


To query a Microsoft Excel database, you enter: 


When you specify criteria to query an external database, you cannot use 
Microsoft Excel computed criteria, as they are Microsoft Excel-specific 
capabilities that cannot be translated into SQL-equivalent functions. For 
example, queries created and applied against external databases cannot use 


This field name cannot be a field name 
from the table you are querying. 


Test criteria 





inogemamaan sg 


To query an external database using SQL, you enter: 


This field name should refer to 
the field name you are querying. 


customer:amt_owed 
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Microsoft Excel cell references or specific Microsoft Excel functions such as 
=AVERAGE(). 


Joining Tables 


Sometimes, you may want to cross-reference information from one table and 
use it to select records from another table. 


You can combine tables by including field names that contain similar data 
from both tables in your criteria. To do so, you need to tell Microsoft Excel 
to cross-reference this information. For example, the Orders table contains a 
list of current customer orders, and the Customer table is a listing of all 
customers. You want a report showing all customers who have an order 
outstanding. To join the cust_num field from the Customer table with the 
cust_nr field from the Orders table, you enter one of the field names as the 
criterion for the other, as follows: 


we name 


customer:cust_num 





The criteria above can be translated as follows: Extract records where the 
cust_num field in the Customer table equals the cust_nr field in the Orders 
table. 
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When you enter criteria that join two tables and then extract the data, the 
extracted data looks as if it came from a single table. 


Defining the Extract Range 


When you define the extract range, you indicate which fields of information 
you want and where to put the information. The appropriate field names must 
be entered on your worksheet. You can either type them or use the Data 
Paste Fieldnames command. You then select the field names and choose the 
Datu Set Extract command. If you select only the field names, Microsoft 
Excel clears all the cells below the field names and places the data there, If 
you select the field names and a range of cells beneath these field names, 
Microsott Excel clears and then fills only that range. 


Hono extret range by defined, Microsoft Hacel aes the current selection on 
the workeaheet aa the eatiet rioge 


‘The extract range must be separate from the erlterla range, The extract range 
can contain the same field names as those in the criteria range, or it can 
contain a different set of field names from the same table. For example, the 
criteria range could request all customers who have both a poor payment 
history and an outstanding order. But in the extract range, you might indicate 
that the data you want to extract is the customer's name and amount owed. 


Extracting the Data 


To extract the data, choose the Data Extract command. Microsoft Excel 
uses the field names and criteria you specify to query the database. The 
information requested is then extracted from the database, and, if there is 
sufficient room in the worksheet, copied to the worksheet. 


miu Initiating a query 


1 Choose Data Paste Fieldnames to specify the field names to be used for 
the criteria or type the field names. 


Enter the criteria beneath the field names. 
Select the criteria range. 


Choose Data Set Criteria. 


ons. W N 


Choose Data Paste Fieldnames to specify the field names you want to 
extract or type the field names. 
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6 Select the extract range by selecting either the field names only or a range 
of cells including the field names. 


7 Choose Data Set Extract. 
8 Choose Data Extract. 


To extract only one copy of repeated records, turn on the Unique Records 
Only check box. 


9 When Microsoft Excel receives the records, you see a message similar to 
the following: 


150 Records Received. 


(saw fe...) [ tameot ) 





To place the information in the worksheet, choose the Paste button. 


To save the information in a file, choose the Save As button. Microsoft 
Excel displays the File Save As dialog box so you can name the file. 


To cancel the query, choose the Cancel button. 


The amount of time your query takes to run depends on many factors, 
including the capacity and load on your host system, and the size and 
complexity of your query. 

When the data is in Microsoft Excel, you can use the Microsoft Excel 
database functions to analyze it. 


Messages 


= When there isn’t sufficient room on the worksheet for the incoming data, 
Microsoft Excel displays a message and either prompts you to specify a 
folder in which to save the data or, if you have already used the Options 
Query Destination command, tells you where the data is stored. 


To designate a particular query destination folder in advance, choose the 
Options Query Destination command. This command is added to the Options 
menu when you open the Data Access Macro. 
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mus Setting a destination volume and folder 
1 Choose Options Query Destination. 


Query Destination 





2 Select the folder you want. 
3 Choose the Set button. 


When you select a folder and choose the Set button, Microsoft Excel 
displays subfolders. 


Messages 


= If you see a message saying that the login script is invalid, the query will 
stop. Choose Data Set Database and check the entries you made to create 
your login script to make sure the information is correct. 


= If you see a message saying that the criteria are invalid, review your 
criteria and be sure you chose the Data Set Criteria command to define 
the criteria range. For more information, see “Entering the Criteria,” 
earlier in this manual. 


= If you see a message saying that the extract range is invalid, review the 
extract range. For more information, see “Defining the Extract Range,” 
earlier in this chapter. 

@ NT yer rete remnige saying that (he parte would extend beyond the sheet, 
Hat mewn there are more field nanien selected than will fit in the remain 
Hae ceetiiitie tee tise reel eel thie wer boliod Mintel Plan! praatorl we rnainy 
He Hert, Yo eon meve (he ext aet Tange HOw poMitOn On the worksheet 
where there is sufficient room to hold the incoming data or save the 
records to a file. 





ws If you see a message saying that there is insufficient disk space to down- 
load the query results, the query will stop. Clear some disk space so there 
is sufficient space. One solution is to copy files that you don’t need on 
your hard disk to floppy disks, and delete them from your hard disk, Then 
extract the data again. 


= If you see a message saying that there is a DAL error or a query error, the 
query will stop. Consult your Data Access Language manual or check 
with your system administrator for help with the message. 


Disconnecting from an External Database 


When you finish using an external database and want to disconnect to free 
resources, use the Data Close Connection command. If you turned off the 
Continuous Connection check box in the Data Set Database dialog box, 
Microsoft Excel disconnects from the external database as soon as it finishes 
querying the database. 


sus Disconnecting temporarily 

» Choose Data Close Connection. 
Choosing Data Paste Fieldnames, Data Extract, or Data Query Assistant 
will reconnect you to the database. 

mus Disconnecting permanently 

1 Choose Data Set Database. 

2 Select the External Database option. 

3 Choose the Change button. 

4 


Choose the Disconnect button. 


Generating Your Own SQL Query 


Tyee dite ae aelvaiieed tine, your niay Witt fo ereite yeni own SOT, query, 
To de thin, you wwe the Data SQL. Query command, When you choose thin 
Heri verre The cere DAT qeamry Your ovr eet tlhe query, saved 
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from the Data SUL Quety dialog box. 


You can enter any valid DAL command, and you can start and end additional 
DAL sessions from within a query. If you do this, however, Microsoft Excel 
will not be able to recognize these sessions as different sessions. 
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When you run a query from the Data SQL Query dialog box, and more than — 


one line is returned, Microsoft Excel tells you the number of lines received. ‘ Using the Query Assistant 


You have the choice of pasting the data on the worksheet, saving the data to 


i i bs . ‘ ‘ ies k 
fil ling th : did whe dee Dieta Bxtraci .,, Chapter The Query Assistant gives you an easy way : ste agi : 
a Ile, or canceling the query, just as you did when you use ata Extrac & 7 with external databases. Everything you can do with Query Assistant, yo 
command. If only one line of information is received, it is pasted into the = can also do with the commands on the Data menu. The Query Assistant just 
active cell. rey 


leads you through the procedure, and helps you create your criteria so you 
don't have to remember how to do it. 


When you choose Data Query Assistant, you see a dialog box that shows you 
the table and fields in the current query, the criteria, and the sort order. You 


can use this dialog box to change the query or generate a new one. If this is 
custemer.crodit_tine, erders.cust_ar, the first query to be created in the Query Assistant during this session, the 
Che lists in the dialog box are blank. 
WHERE ((customer.recelvable 
>customer.credit_tine) OR 
(customer.receivable Specify whether to extract all records 
or unique (distinct) records. 






Tables containing the information. 
This list changes as you change the 
fields in the query. 





Choose the Run button to execute the query. While the query is running, 
messages will appear in the status bar so you know the status of the query. 


The New button clears the current query so you can type a new query in the 
Query Editor dialog box. If the current query has not been saved, you are 
prompted to save it before it is cleared. 


The Open button opens an existing query. You can open any text file in the 
Open dialog box. You can also open and modify queries created using the 
Query Assistant dialog box. If there is an unsaved query in the Query Editor 
when you choose Open, you are prompted to save it before it is cleared. 


The Save button saves the current query to a file from the Query Editor. You 
see the usual Save As dialog box in which you give the query a name. 


Order in which to extract the data. 


Criteria to be used. 


The buttons in the dialog box allow you to add and change fields, criteria, the 
order, and the query in the dialog box. 
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Selecting Field Names from the External Database 


To select the field names you want to extract, you click the Fields button in 
the Query Assistant dialog box. In the Select Fields dialog box are lists of the 
tables in the external database to which you are connected, the field names in 
the table selected in the Table box, and the list of selected field names. You 
can add and remove field names from the list of selected field names, 


You ean remove Chel mien edition inthe Query Aantetaet dlislog box or in 
the Select biclds diulog box, 


nin Selecting field names from the database 


1 Choose Data Query Assistant. 
2 Choose the Fields button. 


3 Inthe Table box, select the table containing the information you want to 
extract. 


4 In the Field box, select the names of the fields you want in your 
Microsoft Excel worksheet. 


To select more than one field name, hold down SHIFT and click the field 
names. 


5 If you want to insert the field names into those already listed in the 
Selected Fields box, select the position where you want the new field 
names to appear. 


6 To add the selected field names, choose the Add button. 
To add all field names, choose the Add All button. 


7 To remove field names from the selected fields list, select the names of 
the fields you want to remove and choose the Remove button. 


To remove all the field names, choose the Clear All button. 


8 When the field names are listed as you want them, choose the Done 
button. 








Chapter 3 
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Using the Query Assistant 
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Specifying Criteria 


NOTE 


The criteria are listed to the right of WHERE in the dialog box. The buttons 


below WHERE allow you to add and remove criteria, 


Use this area to create a new criterion or edit an existing criterion. 


Sevtere tt cneetetinnne. 
@MAtnd Or 


customer:cust_num-orders:cust_nr 
customer:recelvable>custemer:credit_iine 





Existing criteria Use these buttons to add, 
remove, or change criteria. 


You can remove criteria either in the Query Assistant dialog box or in the Set 
Conditions dialog box. 


If the fields are from more than one table, enter a Join criterion by setting a 
field in one table equal to the corresponding field in the other table. For 
example, if you are extracting records from a database named “employees” 
and another named “department,” you could use the following criterion: 
employees.emp_num=department.employee_num. Repeat this type of 
criterion for each table used to define a relationship between the selected 
tables. 
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mint Specifying criteria 
1 In the Query Assistant dialog box, choose the Criteria button. 


2 The left box shows the field name. Type the field name or select from the 
list of available field names. 


3 The center box shows the operation used to compare the two fields. 
Select an operator from the list. 


4 The right box shows either a comparison value or a field name from one 


of the active tables. Type a comparison value or select from the list of 
field names. 


To extract only those records with no information in the field on the left, 
type null in the right box. 


5 To add the criterion as an additional requirement to those already listed, 
select the AND option. 


To add the criterion as an alternate requirement to those already listed, 
select the OR option. 


The AND or OR option is ignored for the first criterion in the list. 


6 If you want to insert the criterion into those already listed, select the 
position where you want the new criterion to appear. 


7 To add the criterion, choose the Add button. 


8 To rennve an existing criterion, select the criterion and choose the 
Remove button 


fotemove all criteria, choose the Clear All button. 
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sun Changing a criterion 

1 In the Query Assistant dialog box, choose the Criteria button. 
2 Select the criterion you want to change. 

3 Choose the Edit button. 
4 


Change the information in the criterion using the boxes at the top of the 
dialog box. 


Choose the Add button. 


When you are finished, choose the Close button. 





Sorting the Fields to be Extracted 


The fields to be extracted can be sorted in any order you want. To change the 
order of the fields, select the name of the field on which you want to sort in 
the Order By box in the Query Assistant dialog box. All records are then 
sorted in order by the information in this field. 


mus Specifying a sort order for the fields 


1 In the Query Assistant dialog box, select the field on which you want to 
sort from the list in the Order By box. 


If you do not want a sort order, select NONE at the top of the list. 
2 To sort the information in ascending order, select the Asc option, 


To sort the information in descending order, select the Desc option. 


Initiating a Query 


To initiate a query after you have set up the criteria, you choose the Run 
button in the Query Assistant dialog box. You are notified as to the number 
of records received, and you can specify whether the records are pasted to the 
worksheet, saved in a file, or you can cancel the query. 


Before running the query, specify whether you want to extract unique records 
or all records by turning the Distinct check box on or off in the Query 
Assistant dialog box. 

soe Thinning a query 


1) Setup the Helds and eriteria. This step is described in detail cartier i this 
a 
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To extract all matching records, turn off the Distinct check box. 

3 Specify a sort order. This step is described in detail earlier in this chapter. 
Choose the Run button. 
To paste the records to the worksheet, choose the Paste button. 


To save the results as a text file, choose the Save As button and type a 
name for the file. 


To cancel the query, choose the Cancel button. 





Saving a Query 
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After you have created a query, you may want to save it for later use. To do 
this, you choose the Save button in the Query Assistant dialog box, where 
you can name the query. 

mus Saving a query 

1 In the Query Assistant dialog box, choose the Save button. 

2 Change to the folder in which you want to save the query. 

3 Type a name for the query. 
4 


Choose the Save button. 


Opening a Query 


Once you have saved queries, you may want to retrieve them to use at a later 
date. To do this, you use the Open button in the Query Assistant dialog box. 
All query assistant files in the current folder are displayed. 


sua ~Opening a query 
1 Choose Data Query Assistant. 
Choose the Open button. 


Ww 


Change to the folder containing the query you want to open. 


> 


Select the query to open. 
Choose the Open button. 


on 


Deleting a Saved Query 


When you are finished using a query that you have previously saved, you can 
delete it if you do not plan to use it again. 


uu Deleting a query 

1 Choose Data Query Assistant. 

Choose the Open button. 

Change to the folder containing the query you want to delete. 
Select the query to delete. 


ah. w nw 


Choose the Delete button. 
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Clearing a Query 
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If you decide you want to remove the query currently listed in the Query 
Assistant dialog box, you do so with the Reset button. 


uu Clearing a query 


P Inthe Query Assistant dialog box, choose the Reset button. 
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Using Functions with DAL 


The Data Access Macro includes several worksheet and macro functions. 
The following list summarizes the functions, most of which are equivalent to 
the commands added to the Data menu: 


CLOSE.CONNECTION( ) 

EXTRACT.EXTERNAL(unique destination filename) 
GET.DATABASE(type_of_ info) 
PASTE.FIELDNAMES(tablename paste_fields) 

QUERY.ASSISTANT?( ) 

QUERY DESTINATION(path) 

SULUEX TERNAL. DATABASE name cont connect dname Jnver hipass, 
dbmsname dbmsuser dbmspass, searchpath databases alias dbuser dbpass) 
SQL(querytext) 

SQL.QUER Y(type.query,destination filename) 

Many functions have an alternative “?” form, such as SQL.QUERY?. This 
form of the function displays the appropriate dialog boxes while the macro is 


running. Each dialog box remains on the screen until you make the selections 
you want. The QUER Y.ASSISTANT? function has the “?" form only. 





Syntax of Functions 


Each DAL function description begins with a main heading that shows the 
function's syntax. This chapter follows the rules for syntax and arguments 
used in the Microsoft Excel Function Reference. In headings, required 
arguments are italic and bold and optional arguments are italic but not bold. 
In text, all arguments are italic. Underline characters represent spaces 
between words; for example, paste_fie/ds is an argument name. For more 
information, see “About Functions” in the Microsoft Excel Function 
Reference. 


Arguments can be: 
=» Numbers 

= Text 

« Logical values 


The two logical values are true and false. If you prefer, you can use ON or | 
for TRUE, and OFF or 0 for FALSE. 
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Macro Sheets Only 


Macro Sheets Only 


Macro Sheets Only 
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CLOSE.CONNECTION) 


The CLOSE.CONNECTION function disconnects the external database. It is 
equivalent to the Data Close Connection command. 


EXTRACT.EXTERNAL (unique,destination, filename) 
EXTRACT.EXTERNAL ?(unique, destination filename) 


The EXTRACT.EXTERNAL function extracts the records in the database 
matching the defined criteria. It is equivalent to the Data Extract command. 


Unique is a logical value corresponding to the Unique Records Only check 
box in the Data Extract dialog box. 


# If unique is TRUE, Microsoft Excel turns on the check box and extracts 
unique records only from the extract list. 


= If unique is FALSE or omitted, Microsoft Excel turns off the check box 
and extracts all records matching the criteria. 


Macro Sheets Only 


Destination is a number from | to 3 indicating the destination for the 
extracted records. 





if destination \s The destination is 

1 rt Selected | range : 
2 File named filename 

3 Selected range and file named filename 


Macro Sheets Only 
Filename is the name of the file in which to save the information if 
destination is 2 or 3. If no filename is entered, the default is “KLCLI 


mm/dd/yy hh:mm:ss” in the query directory. If destination is 1, filename is 
ignored and can be omitted, 


GET.DATABASE\type ot into) 


The GET.DATABASE function is used for obtaining information about the 
current database. 


Macro Sheets Only 





Type_of_info is a number from | to 5 indicating the type of information you 
want about the database. 


if type_of_info is The information returned is 

1 Whether the database is internal (1) or external 
(2) 

Database name 

DBMS brand 

Host name 

Horizontal array of currently active table names 


PASTE.FIELDNAMES\tabiename,paste fields) 
PASTE.FIELDNAMES ?{tabiename,paste_fields) 


The PASTE.FIELDNAMES function inserts the specified field names from 
the given table. It is equivalent to the Data Paste Fieldnames command. 


as. WS NY 


Tablename is the name of the table or array of table names containing the 
field names you want to paste. 


Paste_fields is ignored if tablename is used. If tablename is not used, pastes 
a horizontal array of items into the current selection. 


QUERY.ASSISTANT?() 


Use the QUERY.ASSISTANT? function when you want to use the Query 
Assistant dialog box while running a macro. It is equivalent to the Data 
Query Assistant command. 


QUERY.DESTINATION(path) 
QUERY.DESTINATION ?(path) 


The QUERY.DESTINATION function sets the default directory for saving 


extracted information. It is equivalent to the Options Query Destination 
command, 


Path is a text string indicating the path to the folder in which to save the file 
containing the extracted information. 
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Macto Showin Unly SET.EXTERNAL.DATABASE(iname,cont.connect,hname,tuser,hpass, 
dbmsname,dbmsuser,dbmspass, searchpath, databases, alias, dbuser,dbpass) 


SET.EXTERNAL.DATABASE 2iname,cont.connect hname,huser, M dbmspess is The password Is 


Dbmspase is the password for the databuse canngement system 


i the user. 

hpass,domsname,dbmsuser,dbmspass, searchpath, databases, alias, dbuser, dbpass) TRUE — so 7 a aa Ha ole 
i ot required for i 
The SET.EXTERNAL.DATABASE function connects to the host computer, FALSE or omitted ieee aii 
database management system, and database. It is equivalent to the External ‘ h ified text 
Database option in the Data Set Database command and uses either a login Any text string fy ago tg i sat 
script if one is specified as the first argument or, if no login script exists, you ; gry 
specify the rest of the information necessary to connect to a database. ee, 
The following list summarizes the first two arguments Searchpath is the pathname indicating the location of the databases to use. If 
Pe Ly 7 omitted, searchpath is ignored. 

Frame is the name of a login script, saved as text, containing information oe : 4 ied 
about the host computer, DBMS, database, user names, and passwords. If Databases is the name of the ee to be queried. . 
fname contains a name, the arguments following cont.connect are ignored. Alias is the alias name, to assign a name to the database selection. 
Cont.connect is a logical value corresponding to the Continuous Connection Equivalent to typing a name in the Alias box in the <dbms> Databases dialog 
check box in the Set External Database dialog box. box. 
e = If cont.connect is TRUE or omitted, Microsoft Excel maintains a Dbuser is the user name for the selected databases. 


continuous connection. Dbpass is the password for the selected databases. 
= If cont.connect is FALSE, Microsoft Excel releases the host connection 


j If dbpass is The password is 

between each edie — é . | TRUE Entered by the user. 
If the Prompt Each Login check box is turned on in the login script, FALSE or omitted Not required for logging in to the selected 
Microsoft Excel prompts for each password as it logs in, just as it would database. 
normally vines opening a login script with Prompt Each Login turned on. ves wie ang Automatically entered as the specified text 
The following arguments to the SET.EXTERNAL.DATABASE command string by the macro. 
are ignored and can be omitted if fname contains a name. If no login script 
exists, you use these arguments to specify the information necessary to 3 : : F 
connect to the database: Using the SET.EXTERNAL.DATABASE function with no arguments 

i results in an error. 

Hname is the name of the host system. 


Huser is the assigned user name for the selected host computer. 


SQL (querytext) 
Hpass is the password for the host computer. If blank, Microsoft Excel The SQL function extracts information into the cells containing the formula. 
assumes there is no password required for logging in to the host. If TRUE, This is a worksheet function. 
Microsoft Excel prompts the user for the poor j Querytext is the query to be run each time the cell is calculated. 
Dbmsname is the name of the database management system. 


Dbmsuser is the user name for the database management system. 


Macro Sheets Only 
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SQL.QUERY (type,query, destination, filename) 
SQL.QUERY ? type, query, destination, filename) 


The SQL.QUERY function is used to run a query using the Data SQL Query 
command. 


Type is anumber from | to 4 indicating the type of query to execute: 


if type is The query executed Is 

1 The previous query. If no previous query in this 
session, an error results. 

2 The query defined by query, where query is a 
text string. 

3 The query defined by query, where query is the 


name of a file. 


The query defined by query, where query is a 
system software version 7.0 query document. 


Query is a text string of up to 256 characters: 





If type is = The text In query \s 

1 Ignored a 7 

2 A valid DAL query 

3 The name of a file containing a valid SQL 
query 

4 


A system software version 7.0 query document 


Destination is a number from | to 3 indicating the destination for the 
extracted records. 


If destination is The destination is 

1 Selected range yy = 

2 File named filename 

3 Selected range and file named filename 





Filename is the name of the file in which to save the information if 
destination is 2 or 3. If no filename is entered, the default is “XLCLI 


mm/dd/yy hh:mm:ss” in the query directory. If destination is 1, filename is 
ignored and can be omitted. 


Alias box, using 9 
Arguments 

defined 29 

specific 30-34 
Automatic password =, 9 


C 


Cannot access DBMS message it 


Cannot access field name message 
I 


Changing criteria = 12-15, 24 
ClearAccess 2 
Clearing 

See also Deleting 

queries 27 
CLOSE.CONNECTION function — 30 
Combining tables — 15, 23 
Computed criteria 14 
Connection denied message 9 
Continuous Connection check box = 6 
Criteria 

See also Microsoft Excel User's 

Guide 
adding criteria 24 
changing 12-15, 24 


computed 
in Microsoft Excel 14 
‘ inSQL 14 


criteria invalid message 18 
defined 12 


differences between Microsoft 
Excel and external database 
13-15 


entering 12, 23-24 

operators 13 

removing criteria 24 

simple comparison criteria 
in Microsoft Excel = 13 
inSQL 13-14 


Criteria (continued) 
specifying 
fields from more than one table 
23 


using the Query Assistant = 21 
Criteria invalid message = 18 
Criteria range 


See also Microsoft Excel User's 
Guide 


identifying 12 


D 


DAL error message 19 

Data Access Language (DAL) 
accessing external databases 1, 2 
commands 1, 29 


DAL commands, in SQL Query 
19 


functions, using with = 29-34 
requirements | 
Data Access Macro 
commands |, 29 
defined 1 
installing 3 
opening 
automatically 3 
from Microsoft Excel 3 
with Microsoft Excel 3 
using 1.5 


Data Close Connection command 1, 
19, 30 


Data Extractcommand 2, 16, 17, 19 
Data Extract dialog box 30 
Data, extracting 
from external database 12 
initiating aquery 16 ; 
Data menu commands, equivalence to 
Query Assistant 21 


Data Paste Fieldnames command 1, 
2. 10, 12, 16, 19 


Data Paste Fieldnames dialog box =I 1 


Data Query Assistant command 1, 2, 
19, 21 





Data Query Assistant dialog box —, 
21-27 


Data Set Database command 5-9 
Data Set Database dialog box 6. 19 
Data Set Extract command 16,17 


Data SQL Query command — 1, 2,17, 
19-20 


Data SQL Query dialog box = 2,19, 
20 


Database See External Database 
Database not defined message =I! 
Databases dialog box 9, 30 
DBMS Brand dialog box 7 
Deleting 
See also Clearing 
queries 26 
Destination volume and folder 
designating in advance 17 
setting 18 
Distinct check box 25 


E 


External database 
adding field names IL, 22 
Alias box, using 9 
automatic password 8,9 
changing connection to another = 6 
connectingto 5 
connection denied message 9 
criteria range, identifying 12 
disconnecting from = 19 
extract range, identifying 12 
extracting datafrom = 12, 16 


invalid host information message 
9 


login script, creating  6,7,9 
removing field names 11. 22 
selecting fieldnames 10, 11 
SQL Query, generating 19 
syntax 8&8 
using an existing login script 6 
using the Data Paste Fieldnames 
command = 10, 12, 16, 19 
using the Query Assistant 21, 22 





Extract range 


See also Microsoft Excel User's 
Guide 


defining 16 
identifying 12 
sorting 25 
Extract range invalid message 18 


EXTRACT.EXTERNAL function 
ww 


EXTRACT. EXTERNAL? function 
»” 


Extracting data 12, 16, 20, 25 


F 


Field names 
See also External database 
adding field names 11, 22 


cannot access DBMS message 
i 


cannot access field name message 
W 


database not defined message — I! 
defined 10 
removing field names — 11, 22 
selecting 
from database —-10, 11, 22 
with Query Assistant 21, 22 
sorting 25 
too many field names selected 
message 1 
Functions 
alternate “?" form, described 29 
arguments See Arguments; 
Microsoft Excel Function 
Reference 
CLOSE.CONNECTION 30 
EXTRACT.EXTERNAL 30 
EXTRACT. EXTERNAL? 30 
GET.DATABASE WW 
PASTE.FIELDNAMES 31 
PASTE.FIELDNAMES? 31 
QUERY.ASSISTANT? 31 
QUERY.DESTINATION 31 
QUERY.DESTINATION? 31 


Functions (continued) 


SET.EXTERNAL. DATABASE 


32 


SET. EXTERNAL. DATABASE? 


12 

SQL 33 
SQL.QUERY 34 
SQL.QUERY? 44 
syntax 29 


using with Data Access Language 


(DAL) 29 


G 


GET. DATABASE function 
GQL 2 


H 


Host name dialog box 7 


/ 


Initiating aquery —-16, 20, 25 


” 


Installing the Data Access Macro 


Insufficient disk space message 


3 
19 


Insufficient room for incoming data 


message = 17 


Invalid host information message 


J 


Joining tables 15, 23 


L 


Login script 


changing external database 


connections 6 


connecting to external database 


creating 6-9 

described = 6 

limiting accessto 6 
Login script invalid message 


M 


18 


9 


6 


Macintosh system software version 7.0, 


using 2 


Macro functions See Functions 


Messages 
cannot access DBMS 
cannot access field name 


Messages (continued) 
connection denied 9 
criteria invalid 18 
DALerror 19 
database not defined — 11 
extract range invalid 18 
insufficient disk space 19 


insufficient room for incoming data 
17 


invalid host information 9 

login script invalid = 18 

paste extends beyond sheet ‘1 

query error = 19 

too many field names selected — 11 
Microsoft Excel, SQL differences 1S 


N 


No Password Required option 6, 9 


O 


Opening 
Data Access Macro 3 
queries 26 


Options Query Destination command 
1 R7 


designating a volume and folder in 
advance 17 


p 


Password protection 6, 8, 9 


Paste extends beyond sheet message 
18 


PASTE.FIELDNAMES function 31 
PASTE.FIELDNAMES? function 
31 


Prompt Each Login dialog box 6 


Q 


Query 

clearing 27 

creating =:12, 20, 21-25 

DAL error message 19 

deleting 26 

destination volume and folder 
designating in advance ‘17 
setting 18,23 


Query (continued) 
initiating 16, 20, 25 


insufficient disk space message 
19 


insufficient room for incoming data 
message 17 
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See also Data Query Assistant 
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equivalence to Data menu 
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QUERY.DESTINATION function 
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QUERY .DESTINATION? function 
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Running a query —=-16, 20, 25 
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Saving aquery 20, 26 
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Separate query tools, using 
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SQL query 19, 20 
SQL.QUERY function 34 
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Tables 
joining ~=—-'15, 23 
selecting in database 10,11, 22 


Too many field names selected message 
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Unique Records Only check box 17, 
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Using Functions with DAL = 29 
Using the Data Access Macro 5 
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Worksheet functions See Functions 


